home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 August: Tool Chest / Dev.CD Aug 00 TC Disk 1.toast / pc / sample code / devices and hardware / disks / drivergestaltexplorer / read me Ñ drivergestaltexplorer < prev   
Encoding:
Text File  |  2000-06-23  |  2.5 KB  |  52 lines
  1. Read Me About DriverGestaltExplorer
  2.  
  3. 1.0d1
  4.  
  5. DriverGestaltExplorer is both sample code showing how to call Driver Gestalt and a useful tool for testing your block device driver’s support of Driver Gestalt.
  6.  
  7. About Driver Gestalt
  8.  
  9. Driver Gestalt is a standard set of _Control and _Status calls that allow the system and applications to query device drivers about their functionality.  The focus of Driver Gestalt is block storage device drivers.  All block storage drivers should provide at least a minimal implemention of Driver Gestalt.
  10.  
  11. “Designing PCI Cards and Drivers for Power Macintosh Computers” includes high-level documentation for Driver Gestalt.  In addition, "DriverGestalt.h" provides documentation for specific selectors.
  12.  
  13. Packing List
  14.  
  15. The sample includes the following items:
  16.  
  17. • Read Me — DriverGestaltExplorer — This document.
  18.  
  19. • DriverGestaltExplorer.µ — A CodeWarrior project to build the DriverGestaltExplorer.
  20. • DriverGestaltExplorer — A compiled fat binary of the above.
  21.  
  22. • DriverGestaltExplorer.c — The bulk of the sample code, including the main function.
  23. • TradDriverLoaderLib1.0b5 — A folder containing a cut down version of TradDriverLoaderLib, a useful library for messing with drivers.  The full version of this library is available on the Developer CDs.
  24.  
  25. Building the Sample
  26.  
  27. To build the sample you will need:
  28.  
  29. • The CodeWarrior Pro 3 C compiler.
  30.  
  31. Open the “DriverGestaltExplorer.µ” project file, select the FAT target, and make the project. This results in a fat version of the application.
  32.  
  33. Using DriverGestaltExplorer
  34.  
  35. DriverGestaltExplorer is a simple command line application.  There are two effective commands:
  36.  
  37. 'g' — This command lets you query a single Driver Gestalt selector on a drive you specify.  You will be prompted for the drive number and the selector.  If you enter a drive number of 0, all drives will be queried.
  38.  
  39. 'G' — This command lets you query all the currently defined Driver Gestalt selectors on a drive you specify.  You will be prompted for the drive number.  If you enter a drive number of 0, all drives will be queried for all selectors.
  40.  
  41. Credits and Version History
  42.  
  43. DriverGestaltExplorer was written by Quinn “The Eskimo!” as Apple Developer Technical Support sample code.  If you find any problems with this sample, mail <DevSupport@apple.com> with “Attn: Quinn” as the first line of your mail and I’ll try to fix them up.
  44.  
  45. Version 1.0d1 (Apr 1998) is the first release version.
  46.  
  47. Quinn “The Eskimo!”
  48. Apple Developer Technical Support
  49. Networking, Communcations, Hardware
  50.  
  51. 28 Apr 1998
  52.